package org.ehe.finance.receivable.service;

import com.baomidou.mybatisplus.extension.service.IService;
import org.ehe.common.mybatis.core.page.PageQuery;
import org.ehe.common.mybatis.core.page.TableDataInfo;
import org.ehe.finance.receivable.domain.ErpFinanceReceivable;
import org.ehe.finance.receivable.domain.bo.ErpFinanceReceivableBo;
import org.ehe.finance.receivable.domain.vo.ErpFinanceReceivableVo;

import java.math.BigDecimal;
import java.util.Collection;
import java.util.List;

/**
 * 应收账款服务接口
 * @author :zhangnn
 * @className :ErpFinanceReceivableService
 * @description: 应收账款管理服务接口
 * @date 2025-08-28 10:00:00
 */
public interface ErpFinanceReceivableService extends IService<ErpFinanceReceivable> {

    /**
     * 分页查询应收账款列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 分页结果
     */
    TableDataInfo<ErpFinanceReceivableVo> queryPageList(ErpFinanceReceivableBo bo, PageQuery pageQuery);

    /**
     * 查询应收账款列表
     *
     * @param bo 查询条件
     * @return 结果列表
     */
    List<ErpFinanceReceivableVo> queryList(ErpFinanceReceivableBo bo);

    /**
     * 查询应收账款详情
     *
     * @param id 主键
     * @return 应收账款详情
     */
    ErpFinanceReceivableVo queryById(Long id);

    /**
     * 新增应收账款
     *
     * @param bo 应收账款信息
     * @return 是否成功
     */
    Boolean insertByBo(ErpFinanceReceivableBo bo);

    /**
     * 修改应收账款
     *
     * @param bo 应收账款信息
     * @return 是否成功
     */
    Boolean updateByBo(ErpFinanceReceivableBo bo);

    /**
     * 批量删除应收账款
     *
     * @param ids     主键集合
     * @param isValid 是否校验
     * @return 是否成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 检查单据编号唯一性
     *
     * @param billNo 单据编号
     * @param id     应收账款ID
     * @return 是否唯一
     */
    boolean checkBillNoUnique(String billNo, Long id);

    /**
     * 应收账款收款
     *
     * @param id            应收账款ID
     * @param paymentAmount 收款金额
     * @return 是否成功
     */
    Boolean updatePayment(Long id, BigDecimal paymentAmount);

    /**
     * 获取客户应收账款汇总
     *
     * @param customerId 客户ID
     * @return 汇总信息
     */
    ErpFinanceReceivableVo getCustomerReceivableSummary(Long customerId);

    /**
     * 批量收款
     *
     * @param boList 收款信息列表
     * @return 是否成功
     */
    Boolean batchPayment(List<ErpFinanceReceivableBo> boList);
}
